home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 …ember: Reference Library / Apple Developer Reference Library (December 1999) (Disk 1).iso / pc / what's new / sample code / human interface toolbox / packagetool / simpleprefs.c < prev    next >
Encoding:
C/C++ Source or Header  |  1999-10-22  |  5.7 KB  |  202 lines
  1. /*
  2.     file SimplePrefs.c
  3.     
  4.     Description:
  5.     This file contains routines for managing simple preferences files.
  6.     Here, a preference file contains a flattened collection.
  7.     
  8.     PackageTool is an application illustrating how to create application
  9.     packages in Mac OS 9.  It provides a simple interface for converting
  10.     correctly formatted folders into packages and vice versa.
  11.  
  12.     by John Montbriand, 1999.
  13.  
  14.     Copyright: © 1999 by Apple Computer, Inc.
  15.     all rights reserved.
  16.     
  17.     Disclaimer:
  18.     You may incorporate this sample code into your applications without
  19.     restriction, though the sample code has been provided "AS IS" and the
  20.     responsibility for its operation is 100% yours.  However, what you are
  21.     not permitted to do is to redistribute the source as "DSC Sample Code"
  22.     after having made changes. If you're going to re-distribute the source,
  23.     we require that you make it clear in the source that the code was
  24.     descended from Apple Sample Code, but that you've made changes.
  25.     
  26.     Change History (most recent first):
  27.     10/19/99 created by John Montbriand
  28. */
  29.  
  30.  
  31. #include "SimplePrefs.h"
  32. #include <Folders.h>
  33. #include <Memory.h>
  34. #include <string.h>
  35. #include <Errors.h>
  36. #include <TextUtils.h>
  37.  
  38.  
  39.  
  40. typedef struct {
  41.     OSType creator;
  42.     long databytes;
  43. } PrefFileHeader;
  44.  
  45. enum {
  46.     kMaxNameAttempts = 20
  47. };
  48.  
  49. OSStatus FindThePreferencesFile(OSType fType, OSType fCreator, FSSpec *prefsSpec) {
  50.     short pvol;
  51.     long pdir;
  52.     Str255 name;
  53.     CInfoPBRec cat;
  54.     OSStatus err;
  55.         /* find the preferences folder */
  56.     err = FindFolder( kOnSystemDisk, kPreferencesFolderType, true, &pvol, &pdir);
  57.     if (err != noErr) return err;
  58.         /* search the folder for the file */
  59.     memset(&cat, 0, sizeof(cat));
  60.     cat.hFileInfo.ioNamePtr = name;
  61.     cat.hFileInfo.ioVRefNum = pvol;
  62.     cat.hFileInfo.ioFDirIndex = 1;
  63.     cat.hFileInfo.ioDirID = pdir;
  64.     while (PBGetCatInfoSync(&cat) == noErr) {
  65.         if (((cat.hFileInfo.ioFlAttrib & 16) == 0)
  66.         && (cat.hFileInfo.ioFlFndrInfo.fdType == fType)
  67.         && (cat.hFileInfo.ioFlFndrInfo.fdCreator == fCreator)) {
  68.                 /* make a fsspec referring to the file */
  69.             return FSMakeFSSpec(pvol, pdir, name, prefsSpec);
  70.         }
  71.         cat.hFileInfo.ioFDirIndex++;
  72.         cat.hFileInfo.ioDirID = pdir;
  73.     }
  74.     return fnfErr;
  75. }
  76.  
  77.  
  78. OSStatus GetPreferences(OSType fType, OSType fCreator, Collection preferences) {
  79.     Handle data;
  80.     FSSpec spec;
  81.     short refnum;
  82.     long prefssize, count;
  83.     OSStatus err;
  84.     PrefFileHeader header;
  85.         /* initial state */
  86.     data = NULL;
  87.     refnum = 0;
  88.         /* find the file */
  89.     err = FindThePreferencesFile(fType, fCreator, &spec);
  90.     if (err != noErr) goto bail;
  91.         /* open the file */
  92.     err = FSpOpenDF(&spec, fsRdPerm, &refnum);
  93.     if (err != noErr) goto bail;
  94.         /* measure it's size */
  95.     err = GetEOF(refnum, &prefssize);
  96.     if (err != noErr) goto bail;
  97.         /* read the read the header */
  98.     err = FSRead(refnum, (count = sizeof(header), &count),  &header);
  99.     if (err != noErr) goto bail;
  100.     if (header.creator != fCreator) { err = fnfErr; goto bail; }
  101.         /* create a new handle */
  102.     data = NewHandle(header.databytes);
  103.     if (data == NULL) { err = memFullErr; goto bail; }
  104.         /* read the data fork into the handle */
  105.     HLock(data);
  106.     err = FSRead(refnum, &header.databytes, *data);
  107.     HUnlock(data);
  108.     if (err != noErr) goto bail;
  109.         /* close the file */
  110.     FSClose(refnum);
  111.     refnum = 0;
  112.         /* convert the data to a collection */
  113.     err = UnflattenCollectionFromHdl(preferences, data);
  114.     if (err != noErr) goto bail;
  115.         /* deallocate the handle */
  116.     DisposeHandle(data);
  117.         /* done */
  118.     return noErr;
  119. bail:
  120.     EmptyCollection(preferences);
  121.     if (data != NULL) DisposeHandle(data);
  122.     if (refnum != 0) FSClose(refnum);
  123.     return err;
  124. }
  125.  
  126. OSStatus SavePreferences(OSType fType, OSType fCreator, StringPtr suggestedName, Collection preferences) {
  127.     Handle data;
  128.     Str255 name, namenum;
  129.     FSSpec spec;
  130.     short refnum;
  131.     long count, namecounter;
  132.     OSStatus err;
  133.     Boolean createdFile;
  134.     PrefFileHeader header;
  135.         /* initial state */
  136.     data = NULL;
  137.     refnum = 0;
  138.     namecounter = 1;
  139.     createdFile = false;
  140.         /* check parameters */
  141.     if (CountCollectionItems(preferences) == 0)
  142.         return noErr;
  143.         /* find the file */
  144.     err = FindThePreferencesFile(fType, fCreator, &spec);
  145.     if (err == fnfErr) {
  146.         short pvol;
  147.         long pdir;
  148.             /* find the preferences folder */
  149.         err = FindFolder( kOnSystemDisk, kPreferencesFolderType, true, &pvol, &pdir);
  150.         if (err != noErr) goto bail;
  151.             /* find a free name */
  152.         memcpy(name, suggestedName, suggestedName[0] + 1);
  153.         while (namecounter < kMaxNameAttempts) {
  154.             err = FSMakeFSSpec(pvol, pdir, name, &spec);
  155.             if (err == fnfErr) break;
  156.             if (err != noErr) goto bail;
  157.             NumToString(namecounter++, namenum);
  158.             memcpy(name, suggestedName, suggestedName[0] + 1);
  159.             memcpy(name + suggestedName[0] + 1, &namenum[1], namenum[0]);
  160.             name[0] += namenum[0];
  161.         }
  162.         if (namecounter == kMaxNameAttempts) { err = fnfErr; goto bail; }
  163.         err = FSpCreate(&spec, fCreator, fType, smSystemScript);
  164.         if (err != noErr) goto bail;
  165.         createdFile = true;
  166.     } else if (err != noErr)
  167.         goto bail;
  168.         /* create a new handle */
  169.     data = NewHandle(0);
  170.     if (data == NULL) { err = memFullErr; goto bail; }
  171.         /* flatten the collection to the handle */
  172.     err = FlattenCollectionToHdl(preferences, data);
  173.     if (err != noErr) goto bail;
  174.         /* open the file */
  175.     err = FSpOpenDF(&spec, fsRdWrPerm, &refnum);
  176.     if (err != noErr) goto bail;
  177.         /* write out the header */
  178.     header.creator = fCreator;
  179.     header.databytes = GetHandleSize(data);
  180.     err = FSWrite(refnum, (count = sizeof(header), &count), &header);
  181.     if (err != noErr) goto bail;
  182.         /* write out the data */
  183.     HLock(data);
  184.     err = FSWrite(refnum, &header.databytes, *data);
  185.     HUnlock(data);
  186.     if (err != noErr) goto bail;
  187.         /* crunch!! */
  188.     err = SetEOF(refnum, header.databytes + sizeof(header));
  189.     if (err != noErr) goto bail;
  190.     FSClose(refnum);
  191.     DisposeHandle(data);
  192.         /* done */
  193.     return noErr;
  194. bail:
  195.     if (data != NULL) DisposeHandle(data);
  196.     if (refnum != 0) FSClose(refnum);
  197.     if (createdFile) FSpDelete(&spec);
  198.     return err;
  199. }
  200.  
  201.  
  202.